home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / COMMADIO / HOTKZ42.LZH / HOTKEY-Z.DOC next >
Text File  |  1988-10-26  |  36KB  |  784 lines

  1.  
  2.  
  3.  
  4.  
  5.                       ╔═════════════════════════════════╗
  6.                       ║          HotKey-Z  4.2          ║
  7.                       ║          Documentation          ║
  8.                       ║            10-24-88             ║
  9.                       ║ Copyright 1988 Mark A. Albrecht ║
  10.                       ║       All Rights Reserved       ║
  11.                       ╚═════════════════════════════════╝
  12.  
  13.  
  14.           Prior to running this application, please read the section
  15.           titled SHAREWARE at the conclusion of this document.
  16.  
  17.  
  18.  
  19.       ╔════════════════════════════════════════════════════════════════╗
  20.       ║                                                                ║
  21.       ║                         N O T I C E                            ║
  22.       ║  Many public domain and Shareware programs are being reverse   ║
  23.       ║  engineered by lower life-forms and infected with "viruses"    ║
  24.       ║  which can wreak havok with computer operating systems. The    ║
  25.       ║  only foolproof method of avoiding infection is to refrain     ║
  26.       ║  from using all but commercially purchased programs. A close   ║
  27.       ║  alternative method is to provide the user a means of detect-  ║
  28.       ║  ing program infection before it does any damage. As an        ║
  29.       ║  attempt to ensure that this copy of HotKey-Z has not been     ║
  30.       ║  tampered with, I have included within the program a display   ║
  31.       ║  of the exact size in bytes of the executable portion of the   ║
  32.       ║  program. Please run HotKey-Z the first time from a floppy     ║
  33.       ║  disk and choose main menu option INFO. HotKey-Z's program     ║
  34.       ║  size will be displayed. Exit the program and compare this     ║
  35.       ║  figure with the actual program size. Any discrepency between  ║
  36.       ║  the two figures indicates the copy has been corrupted.        ║
  37.       ║  HotKey-Z has yet to be infected [as far as I know], and my    ║
  38.       ║  intention is to keep it that way. I hope other noncommercial  ║
  39.       ║  software developers incorporate such checks within their      ║
  40.       ║  products so we can put these [people?] out of commission.     ║
  41.       ║                                                                ║
  42.       ╚════════════════════════════════════════════════════════════════╝
  43.  
  44.       ╔════════════════════════════════════════════════════════════════╗
  45.       ║                                                                ║
  46.       ║                     D I S C L A I M E R                        ║
  47.       ║  The author, Mark A. Albrecht, makes no warranties expressed   ║
  48.       ║  or implied as to the quality or performance of this program,  ║
  49.       ║  nor its fitness for a particular purpose. The author will     ║
  50.       ║  not be held liable for any direct, indirect, incidental, or   ║
  51.       ║  consequential damages resulting from the use of this program. ║
  52.       ║  YOUR USE OF THIS PROGRAM CONSTITUTES YOUR AGREEMENT TO THIS   ║
  53.       ║  DISCLAIMER and your release of the author from any form of    ║
  54.       ║  liability or litigation.                                      ║
  55.       ╚════════════════════════════════════════════════════════════════╝
  56.  
  57.  
  58.  
  59.  
  60.  
  61.          ╔══════════════╗
  62.     ═════╣ DESCRIPTION: ╠══════════════════════════════════════════════════
  63.          ╚══════════════╝
  64.  
  65.     HotKey-Z is a menu-driven interface for the popular file transfer
  66.     protocols of Chuck Forsberg's DSZ module. [DSZ is a spectacular
  67.     program. If you use DSZ beyond a trial period, please register with
  68.     Mr. Forsberg.]
  69.  
  70.       PROTOCOLS SUPPORTED:  Support is provided for DSZ's X/Y/Zmodem
  71.                             protocols as well as two additional user-
  72.                             defined external protocols.
  73.  
  74.       CONFIGURABLE:         All arguments/parameters to be passed to DSZ
  75.                             may be specified and saved in HotKey-Z's
  76.                             internal configuration utility.
  77.  
  78.       FILE SELECTION MENU:  Files to be uploaded are selected via a point-
  79.                             and-shoot style menu. Up to five filespecs may
  80.                             be "tagged" for Zmodem and Ymodem batch
  81.                             uploads. Any drive and/or directory is
  82.                             accessible.
  83.  
  84.       MOUSE SUPPORT:        All menus feature built-in mouse drivers.
  85.  
  86.       DISK FUNCTIONS:       Files on any drive may be executed, renamed,
  87.                             deleted, listed, or edited. A user may attach
  88.                             an executable file of his/her choice to the
  89.                             menu for invocation at the press of a key. A
  90.                             DOS gateway is provided for disk functions not
  91.                             supported by HotKey-Z.
  92.  
  93.       FAST AND EFFICIENT:   HotKey-Z is written in Turbo Pascal 4.0 (tm),
  94.                             with much of the code [including ALL screen
  95.                             writes] written in assembler language. Every
  96.                             function of HotKey-Z has been coded to
  97.                             provide lightning-fast execution speed, while
  98.                             reducing disk and RAM overhead to a minimum.
  99.                 
  100.  
  101.  
  102.  
  103.          ╔══════════════════════╗
  104.     ═════╣ SYSTEM REQUIREMENTS: ╠══════════════════════════════════════════
  105.          ╚══════════════════════╝
  106.  
  107.     1 - IBM PC or compatible.
  108.  
  109.     2 - PC/MS DOS 3.0 or later.
  110.  
  111.     3 - Approximately 57K planar RAM in addition to that required by DSZ
  112.        and your comm program.
  113.  
  114.     4 - Efficiency is enhanced by using HotKey-Z on a hard disk but
  115.         performance is acceptable on a floppy.
  116.  
  117.     5 - Color or monochrome monitor.
  118.  
  119.     6 - A communication program supporting access to HotKey-Z via a hotkey
  120.         or DOS gateway.
  121.  
  122.  
  123.  
  124.          ╔═══════════════╗
  125.     ═════╣ INSTALLATION: ╠═════════════════════════════════════════════════
  126.          ╚═══════════════╝
  127.  
  128.     Follow these instructions step-by-step and HotKey-Z should be ready
  129.     to run.
  130.  
  131.      1 - Enter DSZ's pathspec in the "PATH=" command of the AUTOEXEC.BAT
  132.          file of your root directory:
  133.  
  134.      2 - Enter the commands "FILES=20" and "BUFFERS=20" in your CONFIG.SYS
  135.          file.
  136.  
  137.      3 - After having first run HotKey-Z from a floppy and comparing it's
  138.          file size display to it's actual size, copy HotKey-Z to the same
  139.          directory in which your comm program resides.
  140.  
  141.      4 - Enter your comm program and attach HotKey-Z to a hotkey of the
  142.          comm program. For example, Procomm Plus (R) has two hotkeys as
  143.          of this writing: ALT-J and ALT-U. Exit the comm program.
  144.  
  145.      5 - Invoke HotKey-Z and enter the CONFIG utility.
  146.          The CONFIG utility is comprised of input fields which may be
  147.          sequentially accessed by pressing the up and down arrow keys.
  148.          A summary of editing commands is listed on the status line.
  149.          A detailed description of the format for each of the input
  150.          fields follows. Please read each instruction thoroughly to
  151.          familiarize yourself with the general format.
  152.  
  153.      6 - ZMODEM UPLOAD COMMANDLINE:
  154.          This input field holds the entire commandline that will be passed
  155.          to DOS to call DSZ and initiate a Zmodem upload. A caret symbol
  156.          "^" MUST be placed one space after the last parameter in the
  157.          commandline to instruct HotKey-Z to replace the caret with the
  158.          name of the file to be uploaded. For example, the simplest
  159.          commandline would be:
  160.  
  161.                       DSZ.COM sz ^
  162.  
  163.          which, when read by HotKey-Z, instructs the program to insert
  164.          the filespec exactly one space after the "sz" operator. Another
  165.          example of a ZMODEM UPLOAD COMMANDLINE would be :
  166.  
  167.                       DSZ.COM port 1 sz -r ^
  168.                       _______ ______ __ __ __
  169.                             \    \    \  \  \
  170.                              \    \    \  \  \
  171.                               \    \    \  \  FILESPEC MARKER [mandatory]
  172.                                \    \    \  ARGUMENTS [optional]
  173.                                 \    \    OPERATOR [mandatory]
  174.                                  \    ARGUMENTS [optional]
  175.                                   PROTOCOL [mandatory]
  176.  
  177.          In short, you are responsible for supplying ALL of the parameters
  178.          except the name of the file to be sent. The default settings will
  179.          work providing your modem is connected through COM1. This
  180.          commandline will be called when you select HotKey-Z's main menu
  181.          UPLOAD and submenu ZMODEM commands. [Note: ensure that you have
  182.          placed the caret in the proper position--one space after the last
  183.          parameter.]
  184.  
  185.      7 - YMODEM UPLOAD COMMANDLINE:
  186.          Same as 5 above, except operator should be "sb". If you want DSZ
  187.          to use 1k blocks, then the commandline might look like this:
  188.  
  189.                       DSZ.COM sb -k ^
  190.  
  191.  
  192.      8 - XMODEM UPLOAD COMMANDLINE:
  193.          Same as 5 above, except operator should be "sx". If you want DSZ
  194.          to use 1k blocks, then the commandline might look like this:
  195.  
  196.                       DSZ.COM sx -k ^
  197.  
  198.      9 - NAME A:
  199.          HotKey-Z allows two user-defined external upload protocols. The
  200.          name you enter here will become the protocol's menu name. For
  201.          example, if you wanted to be able to use the new Jmodem protocol,
  202.          enter the name "Jmodem". Now "Jmodem" will appear on the menu,
  203.          directly below "Xmodem". [Note: the name must contain one
  204.          capitalized letter which is different from the capitalized letter
  205.          of any of the other upload protocol menu names. If for some odd
  206.          reason the initial letter of the user-defined upload protocol name
  207.          is the same as the initial of one of the other upload protocol
  208.          menu names, then you will have to capitalize a letter other than
  209.          the initial. For example, "xTmodem" instead of "Xtmodem".]
  210.  
  211.     10 - PROTOCOL A UPLOAD COMMANDLINE:
  212.          This is the commandline for the first of two user-defined upload
  213.          protocols. Enter the entire commandline to pass to DOS just as
  214.          you would at the DOS prompt. Remember to place the caret one
  215.          space after the last parameter.
  216.  
  217.     11 - NAME B:
  218.          Same as 8 above, except this is the menu name for the second user-
  219.          defined upload protocol.
  220.  
  221.     12 - PROTOCOL B UPLOAD COMMANDLINE:
  222.          Same as 9 above, except this is the commandline for the second
  223.          user-defined upload protocol. Remember to place the caret one
  224.          space after the last parameter.
  225.  
  226.     13 - ZMODEM DOWNLOAD COMMANDLINE:
  227.          Much like the Zmodem Upload Commandline, you need to enter the
  228.          protocol [DSZ.COM], then any optional arguments [such as
  229.          "port 1"], then the operator ["rz"], then any optional arguments
  230.          [such as "-r"].
  231.  
  232.                * If you wish to have the downloaded file written to a
  233.                  specific directory, then enter the full pathspec as the
  234.                  last parameter [such as "C:\PATH"], but do not place
  235.                  the caret in this field. For example:
  236.  
  237.                       DSZ rz C:\PATH
  238.  
  239.                  will instruct DSZ to write the downloaded file to this
  240.                  directory.
  241.                  [If you do place the caret, HotKey-Z will prompt you for
  242.                  a filename, which is un-necessary for batch downloads.]
  243.  
  244.                * If you wish to override the name of a single-file batch
  245.                  download, then the commandline must use DSZ's "-y"
  246.                  optional argument and then include the caret, like this:
  247.  
  248.                       DSZ -y rz C:\PATH\^
  249.  
  250.                  which instructs HotKey-Z to prompt the user for a file-
  251.                  name, which will be inserted in place of the caret.
  252.                  Got it?!
  253.  
  254.     14 - YMODEM DOWNLOAD COMMANDLINE:
  255.          Same as 12, only operator is "rb".
  256.  
  257.     15 - XMODEM DOWNLOAD COMMANDLINE:
  258.          Xmodem is a non-batch protocol, so you must place a caret in the
  259.          commandline.
  260.  
  261.                * To download a file to the current directory, the
  262.                  commandline might look like this:
  263.  
  264.                       DSZ rx ^
  265.  
  266.                  Make sure a space separates the "rx" and "^" so DSZ
  267.                  doesn't get confused.
  268.  
  269.                * If you wish to have the downloaded file written to a
  270.                  specific directory, then the commandline might look
  271.                  something like this:
  272.  
  273.                       DSZ rx C:\PATH\^
  274.  
  275.                  Make sure there is NO space between the path and "^" or
  276.                  DSZ will scold and dump you.
  277.  
  278.     16 - NAME A:
  279.          The name you enter here will be the menu name for the first
  280.          user-defined download protocol. Remember that you must capitalize
  281.          one of the letters in the name and that letter must not be
  282.          capitalized in any other download protocol name [including
  283.          X/Y/Zmodem].
  284.  
  285.     17 - PROTOCOL A DOWNLOAD COMMANDLINE:
  286.          This is the commandline for the first user-defined download
  287.          protocol. Enter the commandline as your chosen protocol expects
  288.          to receive it. If the protocol needs to have the download file-
  289.          name specified, place a caret at the position the filename
  290.          should be inserted. If a caret is found, HotKey-Z will prompt
  291.          you for a filename prior to calling the protocol.
  292.  
  293.     18 - NAME B:
  294.          The name you enter here will be the menu name for the second
  295.          user-defined download protocol. Remember that you must capitalize
  296.          one of the letters in the menu name and that letter must not be
  297.          capitalized in any other download protocol menu name [including
  298.          X/Y/Zmodem].
  299.  
  300.     19 - PROTOCOL B DOWNLOAD COMMANDLINE:
  301.          This is the commandline for the second user-defined download
  302.          protocol. Enter the commandline as your chosen protocol expects
  303.          to receive it. If the protocol needs a filename, place a caret
  304.          at the position the filename should be inserted. If a caret is
  305.          found, HotKey-Z will prompt you for a filename prior to calling
  306.          the protocol.
  307.  
  308.     20 - LISTER:
  309.          This is the field in which to enter the name of the utility you
  310.          use to list the contents of a text file to the screen [e.g.,
  311.          LIST.COM]. If the utility is not located in the same directory
  312.          as HOTKEY-Z.EXE, then enter it's path in the "PATH=" command of
  313.          AUTOEXEC.BAT.
  314.  
  315.     21 - EDITOR:
  316.          This is the field in which to enter the name of the utility you
  317.          use to edit the contents of a text file. If your editor is not
  318.          located in the same directory as HOTKEY-Z.EXE, then enter it's
  319.          path in the "PATH=" command of AUTOEXEC.BAT.
  320.  
  321.     22 - UTILITY:
  322.          If you have some utility that you need quick access to during a
  323.          communications session [such as a comm program's dialing directory
  324.          sorter], enter it here. When "UTIL" is chosen from the "FILES"
  325.          sub-menu, the contents of this commandline is passed to DOS.
  326.  
  327.     23 - ALARM?
  328.          By default, HotKey-Z sounds a beep at one second intervals upon
  329.          completion of a file transfer, until a key is pressed. Enter "N"
  330.          to disable the alarm, "Y" to enable it. If the alarm is disabled,
  331.          HotKey-Z terminates execution and exits immediately upon
  332.          file transfer completion. If enabled, the alarm sounds until a
  333.          key is pressed, then exits.
  334.  
  335.     24 - MONO DISPLAY?
  336.          "N" if you are using a color monitor, "Y" if your monitor is
  337.          monochrome.
  338.  
  339.     25 - WHISTLES?
  340.          "N" to toggle window whistles off, "Y" to toggle on.
  341.  
  342.  
  343.     HotKey-Z should now be fully configured to run. Browse through the
  344.     operating instructions below, and then get to it!
  345.  
  346.  
  347.  
  348.  
  349.          ╔═══════════════════════╗
  350.     ═════╣ OPERATION IN GENERAL: ╠═════════════════════════════════════════
  351.          ╚═══════════════════════╝
  352.  
  353.     1 - Main menu and submenu items may be selected in one of two ways:
  354.  
  355.         * By using the arrow keys to move the cursor bar over the menu
  356.           selection, then pressing the carriage return key.
  357.  
  358.         * By pressing the character key corresponding to the highlighted
  359.           capitalized initial of the menu item. [On mono displays, the
  360.           capitalized letter will not be highlighted.]
  361.  
  362.     2 - Pressing the Escape key at any menu will return the cursor back to
  363.         the default main menu item.
  364.  
  365.     3 - The main menu consists of seven items: UPLOAD, DOWNLOAD, FILES,
  366.         CONFIG, SHELL, INFO, and QUIT. A discussion of each follows.
  367.  
  368.          ╔════════════════════════╗
  369.     ═════╣ OPERATION IN SPECIFIC: ╠════════════════════════════════════════
  370.          ╚════════════════════════╝
  371.  
  372.     1 - UPLOADS:
  373.         Selecting this main menu item pulls down a submenu consisting of
  374.         five items: ZMODEM, YMODEM, XMODEM, and two user-defined protocols
  375.         we'll refer to as USER-A and USER-B [since you will determine the
  376.         actual names]. Follow the instructions below to initiate an upload:
  377.  
  378.           a. Direct the remote system to prepare to receive a file using
  379.              one of the protocols supported by HotKey-Z.
  380.  
  381.           b. Invoke HotKey-Z.
  382.  
  383.           c. Pull down the UPLOAD submenu. Select the protocol of choice.
  384.              A DRIVE menu will pop up. Choose LOGGED and a file selection
  385.              menu will pop up displaying the root directory of the drive to
  386.              which you are currently logged. Choose OTHER and you will be
  387.              prompted for the drive designator of the root directory you
  388.              want displayed.
  389.  
  390.           d. For all file selection menus, "\.." designates the parent
  391.              directory, capitalized entries preceded by a backslash
  392.              designate subdirectories, and non-capitalized entries desig-
  393.              nate filenames. To move from a subdirectory up to it's parent
  394.              directory, highlight the "\.." entry and press the carriage
  395.              return key. To move from a directory down to a subdirectory,
  396.              highlight the subdirectory name and press the carriage return
  397.              key.
  398.  
  399.              * To upload ONE FILE:
  400.                Highlight the file to upload with the cursor bar and press
  401.                the carriage return key. The file selected will be inserted
  402.                in the commandline of the chosen protocol in place of the
  403.                caret symbol. The file will be uploaded and upon completion
  404.                the transfer completion alarm will sound [if not disabled in
  405.                the CONFIG utility]. If the alarm is enabled, press any key
  406.                to exit the program.
  407.  
  408.              * To upload MULTIPLE FIES [5 maximum]:
  409.                Multiple files may be sent at one time using either ZMODEM
  410.                or YMODEM. XMODEM, being a non-batch protocol, is incapable
  411.                of uploading multiple files in one session. [At this time,
  412.                USER-A and USER-B are recognized as a non-batch protocols,
  413.                thus only one file may be uploaded at one time.]
  414.                Once the file selection menu is brought up, files may be
  415.                tagged by highlighting them with the cursor bar and pressing
  416.                the spacebar. For example, a file could be tagged in the
  417.                directory in which the file selection menu opens, then the
  418.                user could change to another subdirectory and tag another
  419.                file by the same method, and so on, until a maximum of five
  420.                files have been tagged. If you tag a file accidently, you
  421.                may untag it by pressing the delete key. Once all files to
  422.                be uploaded have been tagged, begin the upload by pressing
  423.                the carriage return key. [Note that HotKey-Z creates a text
  424.                file named FILES.LST to temporarily store the names of the
  425.                tagged files to be uploaded. Instead of passing DSZ the
  426.                names of the individual files on the commandline, HotKey-Z
  427.                replaces the commandline caret symbol with the argument
  428.  
  429.                               "@DRIVE:\DIR\FILES.LST"
  430.  
  431.                which informs DSZ to look for filenames therein. This over-
  432.                comes DOS's 80 character commandline length limit. FILES.LST
  433.                will be erased upon exit from HotKey-Z.
  434.  
  435.           e. If not disabled in the CONFIG utility, upon completion of the
  436.              transfer an alarm will sound until any key is pressed, then
  437.              HotKey-Z will terminate execution.
  438.  
  439.  
  440.  
  441.     2 - DOWNLOADS:
  442.         Selecting this main menu item pulls down a submenu consisting of
  443.         five items: ZMODEM, YMODEM, XMODEM, and two user-defined protocols
  444.         we'll refer to as USER-A and USER-B [since you will determine the
  445.         actual names]. Follow the instructions below to initiate a
  446.         download:
  447.  
  448.         a. Direct the remote system to prepare to send a file using one of
  449.            the protocols supported by HotKey-Z.
  450.  
  451.         b. Invoke HotKey-Z.
  452.  
  453.         c. Pull down the DOWNLOAD submenu. Select the protocol of choice.
  454.  
  455.         d. If the chosen protocol's commandline has been configured with a
  456.            caret symbol, you will be prompted to enter the name of the file
  457.            to be received. The caret will be replaced by the name entered.
  458.            If no caret is present, HotKey-Z assumes a batch protocol is
  459.            being used. HotKey-Z passes DOS the commandline associated with
  460.            the menu item selected.
  461.  
  462.         e. If not disabled in the CONFIG utility, HotKey-Z will sound an
  463.            alarm upon completion of the transfer, then exit once a key is
  464.            pressed. If the alarm is disabled, the program will exit
  465.            immediately after the tranfer is completed.
  466.  
  467.  
  468.  
  469.     3 - FILES:
  470.         Selecting this main menu item pulls down a submenu consisting of
  471.         six items: EXECUTE, RENAME, DELETE, LISTER, EDITOR, and a user
  472.         defined item named UTILITY. Each item is discussed below:
  473.  
  474.  
  475.     4 - EXECUTE:
  476.         Any .EXE, .COM, or .BAT file on any drive may be executed from
  477.         within HotKey-Z. If the file to be executed is too big to load into
  478.         memory, you will be notified and execution will be disallowed. If
  479.         the file chosen to be execute resides in different directory than
  480.         the one to which you are currently in, HotKey-Z will jump to that
  481.         directory prior to execution, and jump back when finished.
  482.  
  483.         a. Pull down the FILES submenu. Select EXECUTE.
  484.  
  485.         b. A DRIVE menu will pop up. Choose LOGGED and a file selection
  486.            menu will pop up displaying the root directory of the drive to
  487.            which you are currently logged. Choose OTHER and you will be
  488.            prompted for the drive designator of the root directory you
  489.            want displayed.
  490.  
  491.         c. Select the file to be executed by traversing the directory
  492.            tree until the file is found, then pressing carriage return.
  493.  
  494.         d. HotKey-Z will prompt you for any commandline parameters you
  495.            wish to pass to the file being executed. If none, press the
  496.            carriage return key.
  497.  
  498.         e. Upon exiting from the executed file, press any key to re-enter
  499.            HotKey-Z's main menu.
  500.  
  501.  
  502.     5 - RENAME:
  503.         Any file on any drive may be renamed from within HotKey-Z.
  504.         Directories and subdirectories may not be renamed. To rename a
  505.         file:
  506.  
  507.         a. Pull down the FILES submenu. Select RENAME. Select the drive
  508.            where the target file resides.
  509.  
  510.         b. Select the file to be renamed and press the carriage return
  511.            key.
  512.  
  513.         c. Enter the new name at the prompt. If you decide to back out,
  514.            press the escape key, else press the carriage return key.
  515.  
  516.  
  517.     6 - DELETE:
  518.         Any file on any drive may be deleted (erased). Directories and
  519.         subdirectories may not be removed. To delete a file:
  520.  
  521.         a. Pull down the FILES submenu. Select DELETE. Select the drive
  522.            where the target file resides.
  523.  
  524.         b. Select the file to be deleted and press the carriage return
  525.            key.
  526.  
  527.         c. HotKey-Z will will ask you to verify the command. Reply "Y" to
  528.            delete the file, or "N" to abort the command and return to the
  529.            main menu.
  530.  
  531.  
  532.     7 - LIST:
  533.         Any text file on any drive may be listed to the screen using your
  534.         utility of choice [e.g., LIST.COM]. When this item is selected,
  535.         HotKey-Z will pass to DOS the name of the listing utility, followed
  536.         by the filename chosen to be listed. To list a file:
  537.  
  538.         a. Pull down the FILES submenu. Select LISTER. Select the drive
  539.            where the target file resides.
  540.  
  541.         b. Select the file to be listed and press the carriage return
  542.            key.
  543.  
  544.         c. Upon exit from your lister, press any key to return to
  545.            HotKey-Z's main menu.
  546.  
  547.  
  548.     8 - EDIT:
  549.         Any text file on any drive may be edited using your editor of
  550.         choice [e.g., QEDIT.EXE]. When this item is selected, HotKey-Z
  551.         will pass to DOS the name of your editor, followed by the filename
  552.         chosen to be edited. To edit a file:
  553.  
  554.         a. Pull down the FILES submenu. Select EDITOR. Select the drive
  555.            where the target file resides.
  556.  
  557.         b. Select the file to be edited and press the carriage return
  558.            key.
  559.  
  560.         c. Upon exit from your editor, press any key to return to
  561.            HotKey-Z's main menu.
  562.  
  563.  
  564.     9 - UTILITY:
  565.         Attach any executable file to this menu selection by entering it's
  566.         name in the UTILITY field of HotKey-Z's CONFIG utility. [Comes in
  567.         handy if you need access to an external utility and your comm
  568.         program's hotkeys are all taken.] To execute your utility:
  569.  
  570.         a. Pull down the FILES submenu. Select UTILITY.
  571.  
  572.         b. You will be prompted for any commandline arguments to be passed
  573.            to the utility. If none, press the carriage return key.
  574.  
  575.         c. Upon exit from your editor, press any key to return to
  576.            HotKey-Z's main menu.
  577.  
  578.  
  579.    10 - CONFIG:
  580.         Discussed above, under the heading INSTALLATION.
  581.  
  582.  
  583.    11 - INFO:
  584.         Pops up a window displaying:
  585.  
  586.         a. the current date and time;
  587.  
  588.         b. the size of HotKey-Z's executable code [which, when HotKey-Z is
  589.            invoked for the first time, is used to compare against actual
  590.            program size in order to detect reverse-engineering];
  591.  
  592.         c. the currently logged disk drive;
  593.  
  594.         d. the total size in bytes of the currently logged disk drive;
  595.  
  596.         e. the bytes used on the currently logged disk drive;
  597.  
  598.         f. the bytes free on the currently logged disk drive.
  599.  
  600.    12 - QUIT:
  601.         Exits HotKey-Z by:
  602.  
  603.         a. restoring the cursor;
  604.  
  605.         b. releasing the heap;
  606.  
  607.         c. terminating program execution.
  608.  
  609.  
  610.  
  611.  
  612.          ╔═════════════════╗
  613.     ═════╣ RECENT HISTORY: ╠═══════════════════════════════════════════════
  614.          ╚═════════════════╝
  615.  
  616.         Release 4.0
  617.  
  618.          - Completely rewrote the file selection window routine. Files
  619.            are now displayed in a single, aphabetically sorted column.
  620.            All window commands remain the same as v3.6. A directory tree
  621.            is displayed adjacent to the file display window so the user
  622.            can visualize his/her path on the drive. In addition, if the
  623.            user "tags" the wrong file, he/she may now untag just that
  624.            file, instead of all tagged files.
  625.  
  626.          - Completely rewrote the configuration utility. Each protocol
  627.            commandline must now be entered in it's entirety. I.e., in
  628.            prior versions, the user needed only to specify additional
  629.            arguments to be passed to DSZ [such as "-r", etc.], HotKey-Z
  630.            would handle those arguments which remained static, such as
  631.            "rz", etc.  With this version, the user must specify the
  632.            entire commandline, such as:
  633.  
  634.                            "DSZ port 1 speed 1200 rz -r"
  635.  
  636.            on the ZMODEM DOWNLOAD COMMANDLINE of the config utility.
  637.            [Not to worry, defaults are provided!] This change was
  638.            necessary to allow "power" users more flexibility.
  639.  
  640.          - Added support for a user-defined external protocol, designated
  641.            as OTHER on the upload and download sub-menus. Users must
  642.            specify the entire commandline for the protocol [i.e., the
  643.            protocol filename plus any additional parameters.] HotKey-Z
  644.            will pass this commandline to DOS followed immediately by the
  645.            filename chosen to be uploaded/downloaded.
  646.  
  647.          - Added support for a user-defined external utility. E.g., if the
  648.            user needs to sort the comm program dialing directory on-the-
  649.            fly, he/she could attach the sort utility's name to this menu
  650.            option. A slot is provided in the configuration utility for
  651.            specifying the utility's filename.
  652.  
  653.          - Numerous cosmetic changes make the program, at least for me,
  654.            much more fun to use.
  655.  
  656.          - The directory traversing routines have been totally rewritten to
  657.            eliminate obscure bugs that confused the program. Even if the
  658.            user enters a non-existent directory, HotKey-Z will forge ahead
  659.            by displaying the contents of the currently logged directory.
  660.            The user then need only traverse the directory tree until the
  661.            proper directory is located.
  662.  
  663.          - Numerous other minor changes [which the author can't remember]
  664.            make using HotKey-Z easier than ever.
  665.  
  666.  
  667.         Release 4.1
  668.  
  669.          - Keyboard buffer is now flushed at program termination.
  670.  
  671.          - Eliminated default upload directory. Instead, once the user
  672.            chooses the upload protocol from the main menu, a drive
  673.            selection menu [same as FILES function] pops up. HotKey-Z will
  674.            open it's file display window in the root directory of the drive
  675.            chosen. This way the user is no longer locked-in to one drive
  676.            when selecting a file to upload. However, all files for one
  677.            upload must be on the drive chosen [i.e., you can't tag a file
  678.            in "C:\" and then tag a file in "A:\" and upload both at the
  679.            same time].
  680.  
  681.  
  682.         Release 4.2
  683.  
  684.          - Eliminated single default download directory in favor of
  685.            protocol-specific download directories to be specified in the
  686.            commandline parameters of the respective protocol. [Explained
  687.            above.]
  688.  
  689.          - Added support for an additional user-defined external protocol.
  690.            HotKey-Z now supports DSZ's X/Y/Zmodem protocols plus two
  691.            external protocols.
  692.  
  693.          - The user may specify menu names for each of the user-defined
  694.            external protocols.
  695.  
  696.          - HotKey-Z interprets protocol commandlines differently.
  697.            UPLOADS: A caret symbol "^" MUST be placed within the
  698.                     commandline. HotKey-Z will insert the filespec
  699.                     to be uploaded at exactly the position within
  700.                     the commandline where it finds the caret. If no
  701.                     caret is found, the upload is aborted.
  702.            DOWNLOADS: A caret symbol "^" must be placed within the
  703.                       commandline IF the protocol is non-batch so
  704.                       that HotKey-Z knows to prompt the user for the
  705.                       name of the file to be received. The caret will
  706.                       be replaced by the specified filespec.
  707.            Specifics of the new commandline parameters format is discussed
  708.            in the configuration instructions earlier in this document.
  709.  
  710.          - The directory traversing and file-tagging routines have been
  711.            groomed with a fine-tooth comb. The double-backslash problem
  712.            when selecting a file from a root directory has been eliminated.
  713.            I promise!
  714.  
  715.          - This documentation file has been completely re-written. I hope
  716.            it is now more easily understood.
  717.  
  718.  
  719.  
  720.  
  721.          ╔════════════╗
  722.     ═════╣ SHAREWARE: ╠════════════════════════════════════════════════════
  723.          ╚════════════╝
  724.  
  725.          HotKey-Z is the culmination of hundreds of hours of work. It has
  726.     matured into the most powerful DSZ interface on the market. To assist
  727.     in the continued development of HotKey-Z, the author is distributing
  728.     the publicly released version under the ShareWare concept. Use of this
  729.     application beyond a trial period [typically two weeks] requires regis-
  730.     tration. Unfortunately, I have discovered hundreds of instances where
  731.     the program has been used beyond what any reasonable person would
  732.     define as a trial period. I think this is unfair, particularly given
  733.     the nominal registration fee requested. Therefore I have incorporated
  734.     a use-counter into the program which introduces delayed execution after
  735.     a specified number of uses. This will in no way affect those users who
  736.     register within a reasonable time.
  737.  
  738.          Enclosed in this archive is the registration form for HotKey-Z
  739.     titled REGISTER.ME. Just print it out and fill in the lines. Mail to:
  740.  
  741.                              Mark Albrecht
  742.                              PO Box 2064
  743.                              Sioux City, IA  51104
  744.  
  745.  
  746.  
  747.          ╔══════════════════════════╗
  748.     ═════╣ UPDATES AND INFORMATION: ╠══════════════════════════════════════
  749.          ╚══════════════════════════╝
  750.  
  751.          Updates and new releases of HotKey-Z may be found on this BBS
  752.     operated by Andy Flatt:
  753.  
  754.                               NightHawk RBBS
  755.                               (319) 338-2961
  756.                               Iowa City, IA
  757.  
  758.     A well-maintained and active board that is free and open to all users
  759.     from their very first call. Callers may leave messages to me [Mark
  760.     Albrecht] and I will usually respond within 24 hours. New releases
  761.     can be found in the COMM file directory. Just read or leave a message
  762.     and you may download the newest release on your first call.
  763.  
  764.     Thank you for using and supporting HotKey-Z. I hope it fulfills a need.
  765.  
  766.  
  767.  
  768.  
  769.          ╔══════════════════╗
  770.     ═════╣ ACKNOWLEDGEMENT: ╠══════════════════════════════════════════════
  771.          ╚══════════════════╝
  772.  
  773.     * Thanks go to Dr. Alex Deluca for beta testing recent versions of
  774.       the program.
  775.  
  776.     * DSZ Copyright 1988 Omen Technology, Inc. All rights reserved.
  777.  
  778.     * Turbo Pascal 4.0 is a registered trademark of Borland
  779.       International, Inc.
  780.  
  781.     * Procomm Plus is a registered trademark of Datastorm
  782.       Technologies, Inc.
  783.  
  784.